home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu291.dms / pu291.adf / Clocks / SPClock.Doc < prev    next >
Text File  |  1992-08-03  |  3KB  |  75 lines
  1.  
  2. This program is copyright (C) 1991, by Mark Waggoner
  3.  
  4. Permission is granted to distribute it as long as no charge beyond a 
  5. reasonable  media charge is required.  Reasonable shall be defined to  
  6. be the amount that  Fred Fish charges or last charged for a disk of 
  7. software.
  8.  
  9. SPClock      A clock that uses sprites to display the time.  This allows 
  10.              the clock to remain visible no matter what screen is being 
  11.              displayed and no matter where you scroll on a  Workbench 2.0 
  12.              autoscrolling screen.  Executable and source for Aztec C 5.2.
  13.              Version: 2.1   Author: Mark Waggoner
  14.  
  15. Now, a very slightly longer description:
  16.  
  17. I got tired of looking for the clock window on my autoscrolling workbench
  18. screen so I wrote this clock that uses sprites to display the time.
  19. The time therefore stays on the visible screen at all times, no matter
  20. where you scroll.  It also has the advantage of staying visible on other,
  21. non-workbench screens.  Some disadvantages: You can't move it and it may not 
  22. cooperate well with sprite based games.  These don't bother me.  I also 
  23. found  that it didn't work too well on a super-hires screen.
  24.  
  25. From Workbench:
  26.   Double click on the icon to start.  Double click again to stop.
  27.  
  28. Or... If you really want to use the CLI, try:
  29.   run >nil: SPClock >nil: <nil:
  30. To stop the clock, run it again or send it a control-C with the BREAK command.
  31.  
  32. TOOLTYPES and CLI options:
  33.   LEFT=x        The coordinate of the left side of the clock.
  34.   TOP=x         The coordinate of the top of the clock.
  35.                 Note that these coordinates seem to be in a 320x200, 
  36.                 regardless of the type of screen you have open.
  37.  
  38.   COLOR=r g b   The color of the time (r,g,b = 0-15)
  39.   COLOR1=r g b
  40.  
  41.   SHADOW=r g b  The color of the time's shadow (r,g,b = 0-15)
  42.   COLOR2=r g b
  43.  
  44.   COLOR3=r g b  The color of the dot between the colon that appears for PM.
  45.  
  46.   24HOUR        display the time in 24 hour mode.  I think the skinny
  47.                 2 that I use for this looks pretty ugly.
  48.  
  49.   NOBLINK       Don't blink the colon.
  50.  
  51. CLI Options are the same as the tooltypes.  For example:
  52.  
  53.   SPClock LEFT=100 TOP=1 COLOR=14 0 14 SHADOW=15 15 15 COLOR3=0 0 0
  54.  
  55. Options from CLI only!
  56.   START         Only start spclock.  If it is already running, don't exit.
  57.   QUIT          Only quit spclock.  If it is NOT already running, don't start.
  58.  
  59.  
  60. The fonts used for the numbers were created from the text file "nums"
  61. with the ARexx program nums2c.rexx.
  62.  
  63. Also note that this has VERY nonstandard startup code.  You cannot use any
  64. unix style standard i/o, the malloc function, floating point, and probably
  65. a lot of other things.  The main routine is not called like a normal C 
  66. main(). I got to looking at all the junk that gets included with a "normal" 
  67. C program and decided to cut it down a bit.
  68.  
  69. There are a number of things in the source that I'm sure can be done some
  70. better way.  I'd appreciate a note if you make improvements.
  71.  
  72. Mark Waggoner
  73. waggoner@ichips.intel.com
  74. (503) 681-9818
  75.